Insert(Int32,Object[]) Method

Inserts a row into the collection at the specified position, and populates the cells with the specified objects.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#

<FeatureAttribute(Name="RowCollection", Version="v5.0")>
Public Overloads Overridable Sub Insert( _
   ByVal rowIndex As Integer, _
   ByVal ParamArray values() As Object _
)

Dim instance As RowCollection
Dim rowIndex As Integer
Dim values() As Object
 
instance.Insert(rowIndex, values)

[Feature(Name="RowCollection", Version="v5.0")]
public virtual void Insert( 
   int rowIndex,
   params object[] values
)

Parameters

rowIndex: The position at which to insert the row.
values: A variable number of objects that populate the cells of the new row.

Exceptions

Exception	Description
System.InvalidOperationException	This method is accessed when Template is a null reference (Nothing in Visual Basic). -or- The rowIndex is equal to the number of Rows in the collection and the AllowUserToAddRows property of the GcMultiRow control is set to true. -or- The DataSource property of the GcMultiRow control is not a null reference (Nothing in Visual Basic).
System.ArgumentOutOfRangeException	The rowIndex is less than 0 or greater than the number of Rows in the collection.
System.ArgumentNullException	The values parameter is a null reference (Nothing in Visual Basic).

Exception

Description

System.InvalidOperationException

This method is accessed when Template is a null reference (Nothing in Visual Basic).

-or-

The rowIndex is equal to the number of Rows in the collection and the AllowUserToAddRows property of the GcMultiRow control is set to true.

-or-

The DataSource property of the GcMultiRow control is not a null reference (Nothing in Visual Basic).

System.ArgumentOutOfRangeException

The rowIndex is less than 0 or greater than the number of Rows in the collection.

System.ArgumentNullException

The values parameter is a null reference (Nothing in Visual Basic).

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

RowCollection Class
RowCollection Members
Overload List